OpenPassExam 零基礎新手全圖文上手指南 📝

這是一份專門為完全不懂電腦、不想看複雜指令的使用者所準備的超親切操作手冊。
只要按照步驟一步一步跟著做，您就可以在網頁或手機上輕鬆刷題，並享有頂尖 AI 智慧家教的專業解說！

🌟 方式一：最推薦！用網頁瀏覽器直接開啟（最簡單，免安裝）

不用下載任何軟體，不管是手機、平板或電腦，只要能連上網路就能直接開始！

步驟 1：開啟網址

1. 打開您的網頁瀏覽器（如 Google Chrome、Microsoft Edge、Safari）。
2. 在網址列輸入或點擊官方雲端網址：
   👉 https://openpassexam-web-960431413562.asia-east1.run.app
   (備註：若管理者已綁定自訂網域，請直接輸入管理者提供的專屬網址)

步驟 2：登入帳號或以訪客身分體驗

• 推薦！Google 帳號一鍵登入：
  • 點擊畫面右上角的 「Google 登入」 按鈕。
  • 選擇您的 Google 帳號，1 秒內即可無縫登入！
  • 好處：系統會為您永久保存作答紀錄、錯題本、個人筆記與收藏清單，換手機或換電腦都不怕進度遺失。
• 訪客模式：
  • 若您暫時不想登入，亦可直接點擊 「訪客體驗」，直接暢看免費精選題目。

步驟 3：開始刷題與 AI 家教解說

1. 選擇科目：從清單選擇欲報考之專業證照科目（如 Cisco CCNA 200-301、AWS Certified Solutions Architect、Azure 等），亦可探索社群創作者發布的自訂考題。
2. 練習與測驗模式：
   • 循序練習：邊做邊看答案與官方解析。
   • 全真模擬測驗：模擬正式考場倒數計時，測驗完成後自動產生成績雷達圖與能力診斷。
3. 召喚 AI 智慧家教：
   • 遇到不懂的題目，點擊題目下方的 「🧠 AI 智慧解析」 或 「💬 向家教提問」。
   • AI 家教採用全方位資深專家視角，深入解析底層通訊協定、RFC 標準、網路拓撲運作機制，並提供實戰 CLI 指令與除錯心法！

📱 方式二：在 Android 手機 / 平板上安裝 App

如果您想在 Android 手機或平板上獲得如同原生應用的極致流暢手感：

步驟 1：取得安裝檔 (.apk)

• 由開發者提供的官方發布頁或雲端硬碟下載最新版的 app-release.apk。

步驟 2：一鍵安裝與權限允許

1. 打開手機的「檔案管理」或「下載內容」，找到剛下載的 .apk 檔案並點擊。
2. 若手機系統彈出提示：「為了您的安全性，手機目前不允許安裝來源不明的應用程式」：
   • 請點擊提示中的 「設定」。
   • 將 「允許來自此來源的應用程式」 開關切換為開啟。
3. 返回安裝畫面，點擊 「安裝」。
4. 安裝完成後點擊 「開啟」，即可進入 OpenPassExam 隨時隨地離線刷題！

🔑 方式三：如何 1 分鐘免費啟用 Gemini AI 智慧家教 (BYOK 自備金鑰)

OpenPassExam 採用現代最受歡迎的 BYOK (Bring Your Own Key，自備金鑰) 架構，讓您享有 Google 官方每天高達數千次的高額免費額度，同時徹底守護個人隱私：

步驟 1：免費申請 Google 官方金鑰（1 分鐘，免信用卡）

1. 使用電腦或手機瀏覽器開啟 Google AI 官方網站：
   👉 Google AI Studio 官方金鑰申請頁面
2. 使用您的 Google 帳號登入。
3. 點擊藍色的 「Create API key」（建立 API 金鑰）按鈕。
4. 點擊 「Copy」（複製）產生出來的金鑰代碼（格式通常為 AIzaSy... 或最新 AQ...）。

步驟 2：在 OpenPassExam 中貼上金鑰

1. 開啟 OpenPassExam 網頁或 App。
2. 點擊底部導航列的 「AI 家教」，再點擊右上角的 🔑 鑰匙圖示（或前往「設定」➔「AI 家教設定」）。
3. 將剛剛複製的金鑰貼入輸入框中。
4. 支援多把金鑰輪替池：若您有多個 Google 帳號，可以貼入多組金鑰（每行一組），系統會自動平均輪替，免費額度倍數翻倍！
5. 點擊 「儲存設定」。

步驟 3：完成！享受頂尖雙模智慧

• 系統會優先調用最新旗艦級 Gemini 3.8 / 3.7 Flash 深度思考模型，並備有自動回退機制（降級至 Gemini 2.5/2.0）。
• 🛡️ 本機端側離線保護：若遇到斷網或金鑰免費額度用罄，系統會自動切換為本機 Gemma 4 (2B) 離線引擎 無縫接管，解題不中斷！
• 🔒 隱私承諾：您的金鑰僅儲存於您個人的瀏覽器快取或手機端，絕不上傳至任何雲端伺服器。

💻 方式四：管理者指南：在 Windows 電腦一鍵自動發布更新到雲端

如果您是系統管理員，希望將最新版考題與介面更新部署到 Google Cloud Run：

1. 開啟 PowerShell：
   • 在鍵盤按下 Windows 鍵，輸入 PowerShell，點擊開啟。
2. 切換到專案資料夾並執行一鍵發布：

   cd "c:\alan\google cloud app\OpenPassExam"
   .\deploy.ps1
   

3. 喝杯咖啡等待：
   • 腳本會自動讀取設定、調用 Google 雲端超級電腦進行編譯與打包，並自動部署至 Cloud Run。
   • 部署完成後，畫面上會直接印出正式上線的綠色網址！

💡 常見問題與解答 (Q&A)

Q1: 網頁打開後出現空白或一直轉圈圈？

• 解答：第一次載入時，瀏覽器正在快取最新考題與多模態圖片資源。請稍等 3~5 秒。若仍無反應，可按鍵盤 Ctrl + F5（手機請由上往下滑動重新整理）即可。

Q2: 沒填寫 Gemini API Key 還可以使用嗎？

• 解答：完全可以！未設定 Key 時，您依然可以正常作答，並閱讀內建的官方標準解析與端側本機離線推理。填入免費 Key 後，則能享有即時互動提問、通訊協定深度剖析等進階 AI 專屬家教功能。

Q3: 刷題需要一直連著網路嗎？

• 解答：一般題目練習、章節測驗與歷史紀錄皆具備完整的本機離線快取；若需使用 Google 雲端 Gemini AI 即時對話、同步最新線上題庫或執行 Google 帳號登入，則需保持網路連線。

Q4: 提問時提示「API Key 配額已耗盡 (429 RESOURCE_EXHAUSTED)」怎麼辦？

• 解答：這代表您當前的 Google 免費帳號今日配額已達上限。請點擊 🔑 鑰匙圖示，貼上第二組或第三組 Google AI Studio 金鑰建立「金鑰輪替池」，系統會自動秒級切換；或者等待隔日 Google 配額自動重設。

Q5: Google 帳號登入安全嗎？會不會洩漏個人資料？

• 解答：OpenPassExam 採用 Google 官方 Firebase Authentication 與 OAuth 2.0 協議，登入過程由 Google 官方伺服器直接驗證，本平台無法得知也不會儲存您的 Google 帳號密碼。

Q6: 遇到問題或發現題目有筆誤，如何回報？

• 解答：歡迎至 GitHub 官方儲存庫的「Issues」專區回報，或於題庫介面點擊「題目回報」按鈕，我們將第一時間修正！